home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / abild.z / abild
Text File  |  1998-10-30  |  15KB  |  331 lines
  1.  
  2.  
  3.  
  4. AAAABBBBIIIILLLLDDDD((((1111))))                                                              AAAABBBBIIIILLLLDDDD((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      abild - ABI link editor
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      aaaabbbbiiiilllldddd [ option ] ...  _f_i_l_e ...
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      aaaabbbbiiiilllldddd is a wrapper shell script for lllldddd for link editing MMMMIIIIPPPPSSSS AAAABBBBIIII
  16.      applications.  It translates a common subset of the SVR4 SGS (Software
  17.      Generation System) flags and arguments to those of the native IDO (IRIS
  18.      Development Option).  By the use of this wrapper, applications which link
  19.      "on-site" on a target platform are isolated from having to know the
  20.      details of invoking that platform's compilation system.
  21.  
  22.      aaaabbbbiiiilllldddd also serves to hide the details of constructing an ABI application
  23.      on IRIX.  The details of exactly how the native lllldddd constructs an ABI
  24.      application are not guaranteed to remain unchanged, so aaaabbbbiiiilllldddd should be
  25.      used to link all ABI-compliant programs to insure portability.
  26.  
  27.      The following options are recognized by aaaabbbbiiiilllldddd; options which are not
  28.      applicable are (generally) silently ignored.  Further details available
  29.      in the _U_N_I_X _S_y_s_t_e_m _V _R_e_l_e_a_s_e _4 _P_r_o_g_r_a_m_m_e_r'_s _R_e_f_e_r_e_n_c_e _M_a_n_u_a_l.
  30.  
  31.      ----aaaa    undefined references generate errors (static mode)
  32.  
  33.      ----BBBB ssssttttaaaattttiiiicccc
  34.            look only for static archives during link phase
  35.  
  36.      ----BBBB ddddyyyynnnnaaaammmmiiiicccc
  37.            look for DSOs first, then static archives. during link phase
  38.  
  39.      Note that the ----BBBB ssssttttaaaattttiiiicccc and ----BBBB ddddyyyynnnnaaaammmmiiiicccc options serve as toggles and can
  40.      be specified multiple times on a command line.
  41.  
  42.      ----BBBB ssssyyyymmmmbbbboooolllliiiicccc
  43.           when building a DSO, bind references to global symbols to their
  44.           definitions within the object
  45.  
  46.      ----BBBB ssssyyyymmmmbbbboooolllliiiicccc====_n_a_m_e,...
  47.           when creating a DSO, bind the named reference to their definitions
  48.           within the object if there is a definition in the object.  Not
  49.           supported at present.
  50.  
  51.      ----BBBB ssssyyyymmmmbbbboooolllliiiicccc____ffffiiiilllleeee====_f_i_l_e_n_a_m_e
  52.           when creating a DSO, the file _f_i_l_e_n_a_m_e contains a list of symbols
  53.           that should be bound to their definitions within the object if there
  54.           is a definition in the object.  Not supported at present.
  55.  
  56.      ----BBBB eeeexxxxppppoooorrrrtttt
  57.           when creating a DSO, indicates that symbols from the next object,
  58.           archive, or DSO are exported fron the DSO being created.  This is
  59.           the default for an object but not for an archive or DSO.
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. AAAABBBBIIIILLLLDDDD((((1111))))                                                              AAAABBBBIIIILLLLDDDD((((1111))))
  71.  
  72.  
  73.  
  74.      ----BBBB eeeexxxxppppoooorrrrtttt====_n_a_m_e,...
  75.           when creating a DSO, marks the symbols given by the list of _n_a_m_e_s as
  76.           exported.  If any symbols are exported by this mechanism then all
  77.           unspecified symbols will be automatically hidden.  _f_i_l_e_n_a_m_e contains
  78.           a list of symbols that should be exported.  Any symbols not
  79.           specifically exported will be automatically hidden.
  80.  
  81.      ----BBBB eeeexxxxppppoooorrrrttttssss____ffffiiiilllleeee==== ffffiiiilllleeeennnnaaaammmmeeee
  82.           when creating a DSO, the file given by _f_i_l_e_n_a_m_e contains a list of
  83.           symbols that should be exported.  Any symbols not specifically
  84.           exported will be automatically hidden.
  85.  
  86.      ----BBBB hhhhiiiiddddeeee
  87.           when creating a DSO, indicates that symbols from the next object,
  88.           archive, or DSO are hidden in the DSO being created.  This is the
  89.           default for an archive or DSO but not for an object.
  90.  
  91.      ----BBBB hhhhiiiiddddeeee====_n_a_m_e,...
  92.           when creating a DSO, marks the symbols given by the list of _n_a_m_e_s as
  93.           hidden.  Ignored if any symbols are exported by the
  94.           ----BBBB eeeexxxxppppoooorrrrtttt====_n_a_m_e,...  or ----BBBB eeeexxxxppppoooorrrrttttssss____ffffiiiilllleeee====_f_i_l_e_n_a_m_e options.
  95.  
  96.      ----BBBB hhhhiiiiddddeeeessss____ffffiiiilllleeee====_f_i_l_e_n_a_m_e
  97.           when creating a DSO, the file given by _f_i_l_e_n_a_m_e contains a list of
  98.           symbols that should be hidden.  Ignored if any symbols are exported
  99.           by the ----BBBB eeeexxxxppppoooorrrrtttt====_n_a_m_e,...  or ----BBBB eeeexxxxppppoooorrrrttttssss____ffffiiiilllleeee====_f_i_l_e_n_a_m_e options.
  100.  
  101.      ----BBBB oooobbbbjjjjeeeeccccttttlllliiiisssstttt====_f_i_l_e_n_a_m_e
  102.           the object files named in the file _f_i_l_e_n_a_m_e are linked in.
  103.  
  104.  
  105.      ----BBBB rrrrppppaaaatttthhhh====_P_A_T_H
  106.           _P_A_T_H is a directory. specifies the rpath pathname when linking
  107.           ----sssshhhhaaaarrrreeeedddd (IRIX cc option) or when using the ----GGGG option.  The dynamic
  108.           linker will search the named directory first.
  109.  
  110.      ----BBBB nnnnoooolllliiiibbbbrrrraaaarrrryyyyrrrreeeeppppllllaaaacccceeeemmmmeeeennnntttt
  111.           Turns on a flag in the dynamic section so that rld does not allow
  112.           execution time or runtime changing of the path (except for super
  113.           user) to find the DSOs (Dynamic Shared Objects). Typically, used for
  114.           security purposes on system utilities.
  115.  
  116.      ----bbbb   controls DSO linkage.  Silently ignored by IRIX.
  117.  
  118.      ----dddd nnnn use static linking.  Statically linked executables are not MIPS ABI
  119.           conforming.
  120.  
  121.      ----dddd yyyy use dynamic linking (the default) to create a dynamic executable.
  122.  
  123.      ----eeee _e_p_s_y_m
  124.           sets entry point to be _e_p_s_y_m.
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. AAAABBBBIIIILLLLDDDD((((1111))))                                                              AAAABBBBIIIILLLLDDDD((((1111))))
  137.  
  138.  
  139.  
  140.      ----GGGG   produce a DSO.  This option is used when generating a DSO (dynamic
  141.           shared object) (as opposed to a dynamic executable).  When using the
  142.           ----GGGG option, one usually also specifies the outfile file name using,
  143.           ----oooo _f_i_l_e._s_o and  the "soname" using, ----WWWWllll,,,,----ssssoooonnnnaaaammmmeeee,,,,_f_i_l_e._s_o....
  144.  
  145.      ----hhhh  _n_a_m_e
  146.           controls dynamic linking name lookup (look for _n_a_m_e instead of the
  147.           filename). This option is not supported on IRIX.
  148.  
  149.      ----IIII  _n_a_m_e
  150.           specifies an interpreter to be linked with a.out .
  151.  
  152.      ----LLLL  _p_a_t_h
  153.           add _p_a_t_h to library search directories.
  154.  
  155.      ----llll_x  search the specified library
  156.  
  157.      ----MMMM  _m_a_p_f_i_l_e
  158.           use specified map file as a file of directives to lllldddd.  This option
  159.           is not supported on IRIX.
  160.  
  161.      ----mmmm   produce a memory map.
  162.  
  163.      ----oooo  _o_u_t_f_i_l_e
  164.           names the output file.
  165.  
  166.      ----QQQQ nnnn suppress compiler identification in output.
  167.  
  168.      ----QQQQ yyyy generate compiler identification in output.
  169.  
  170.      ----rrrr   combine object files into a relocatable object file.
  171.  
  172.      ----ssss   strip symbolic debugging information.
  173.  
  174.      ----tttt   suppress warning about multiple defined symbols of different sizes.
  175.  
  176.      ----uuuu  _s_y_m_n_a_m_e
  177.           enters named symbol as an undefined.
  178.  
  179.      ----vvvv   verbose mode.
  180.  
  181.      ----VVVV   output a version identifier string.
  182.  
  183.      ----XXXX rrrreeeeaaaaddddwwwwrrrriiiitttteeee____ccccoooonnnnsssstttt
  184.           Place the contents of _c_o_n_s_t data in a writable segment of memory.
  185.           This is the default.
  186.  
  187.      ----XXXX rrrreeeeaaaaddddoooonnnnllllyyyy____ccccoooonnnnsssstttt
  188.           Place contents of _c_o_n_s_t data in a read-only segment of memory.  This
  189.           option should be when programs which will be redistributed in on-
  190.           site linkable object code as well as binary form are generated, as
  191.           some of the other ABI platforms support only this behavior.
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. AAAABBBBIIIILLLLDDDD((((1111))))                                                              AAAABBBBIIIILLLLDDDD((((1111))))
  203.  
  204.  
  205.  
  206.      ----XXXX xxxxppppgggg
  207.           directs the compiler to set the global variable ________xxxxppppgggg4444 to 1; this
  208.           indicates that libraries should provide behavior compatible with the
  209.           _X/_O_p_e_n _S_i_n_g_l_e _U_N_I_X(_T_M) _S_p_e_c_i_f_i_c_a_t_i_o_n rather than the default
  210.           traditional behavior where there is a conflict.
  211.  
  212.      ----XXXX 33332222
  213.           generate a 32-bit object.  This is the default.  Defaults to
  214.           ----XXXX mmmmiiiippppssss1111 ....
  215.  
  216.      ----XXXX 66664444
  217.           generate a 64bit object.  Defaults to ----XXXX mmmmiiiippppssss3333 ....
  218.  
  219.      ----XXXX mmmmiiiippppssss1111
  220.           generate code using the MIPS I instruction set of the R2000/R3000
  221.           RISC architecture.  Defaults to ----XXXX 33332222 ....
  222.  
  223.      ----XXXX mmmmiiiippppssss2222
  224.           generate code using the MIPS II instruction set (MIPS 1 + R4000
  225.           specific extensions).  Defaults to ----XXXX 33332222 ....
  226.  
  227.      ----XXXX mmmmiiiippppssss3333
  228.           generate code using the MIPS III (R4000) instruction set.  Defaults
  229.           to ----XXXX 66664444 ....
  230.  
  231.      ----XXXX mmmmiiiippppssss4444
  232.           generate code using the MIPS IV (R10000,R5000,R8000) instruction
  233.           set.  Defaults to ----XXXX 66664444 ....
  234.  
  235.      ----YYYYPPPP,,,,_d_i_r_l_i_s_t
  236.           controls library search list.  This option is not supported and
  237.           generates a warning message.
  238.  
  239.      ----zzzz ddddeeeeffffssss
  240.           force fatal error for undefined symbols at the end of the link
  241.           (default when building an executable)
  242.  
  243.      ----zzzz nnnnooooddddeeeeffffssss
  244.           allow undefined symbols (default when building a DSO).
  245.  
  246.      ----zzzz tttteeeexxxxtttt
  247.           in dynamic mode, force a fatal error if relocations against
  248.           unwritable, allocatable sections remain
  249.  
  250.      ----WWWWllll,,,,aaaarrrrggggssss[[[[,,,,aaaarrrrgggglllliiiisssstttt]]]]
  251.           This IRIX-specific option is used to pass SGI specific options to
  252.           the underlying link command.
  253.  
  254. NNNNOOOOTTTTEEEESSSS
  255.      The OPTIONS section above indicates a space character between options and
  256.      option-arguments.  This is in accordance with _X/_O_p_e_n recommendations for
  257.      portable applications.  _a_b_i_c_c also supports placing its option-argument
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. AAAABBBBIIIILLLLDDDD((((1111))))                                                              AAAABBBBIIIILLLLDDDD((((1111))))
  269.  
  270.  
  271.  
  272.      in the same string with no space.  If the option-argument is optional, no
  273.      space is allowed and this is reflected in the OPTIONS section.
  274.  
  275.      When aaaabbbbiiiilllldddd is used, the only library in the default search path is
  276.      /_u_s_r/_l_i_b/_a_b_i.  If /_u_s_r/_l_i_b is searched, an ABI binary won't be built.
  277.  
  278.      ----XXXX 33332222 may only be combined with ----XXXX mmmmiiiippppssss1111 or ----XXXX mmmmiiiippppssss2222 .... ----XXXX 66664444 may only be
  279.      combined with ----XXXX mmmmiiiippppssss3333 or ----XXXX mmmmiiiippppssss4444 ....
  280.  
  281. FFFFIIIILLLLEEEESSSS
  282.      /usr/lib/abi    ABI libraries and configuration files
  283.      /usr/lib64/abi    ABI libraries
  284.      /usr/lib64/mips3/abi    ABI libraries
  285.      /usr/lib64/mips4/abi    ABI libraries
  286.      /usr/include/abi        special ABI include files
  287.      /usr/lib/abi/setup      abild setup file
  288.      /usr/lib/abi/sgild.cfg  IRIX abild config file
  289.  
  290. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  291.      abicc(1), check_abi_compliance(1), check_abi_interface(1),
  292.      check_for_syscalls(1), abi(5)
  293.      _M_I_P_S _P_r_o_c_e_s_s_o_r _A_B_I _C_o_n_f_o_r_m_a_n_c_e _G_u_i_d_e
  294.      _U_N_I_X _S_y_s_t_e_m _V _R_e_l_e_a_s_e _4 _P_r_o_g_r_a_m_m_e_r'_s _R_e_f_e_r_e_n_c_e _M_a_n_u_a_l
  295.      http://www.mipsabi.org has the MIPS ABI documents.
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.                                                                         PPPPaaaaggggeeee 5555
  328.  
  329.  
  330.  
  331.